home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / uhren & terminkalender / organizer / stickit2 / docs / stickit2.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  29KB  |  573 lines
  1. @database StickIt2.guide
  2. @Master stickit2.texi
  3. @Width 72
  4. This is the AmigaGuide
  5.  file StickIt2.guide, produced by Makeinfo-1.55 from 
  6. the input file stickit2.texi.
  7.    StickIt2, the Amiga sticky note reminder program.
  8.    Copyright (C) 1993,1994 Andy Dean.
  9. @Node Main "StickIt2.guide"
  10. @Next "Copying"
  11.    Welcome to StickIt2, the Amiga sticky note reminder program!
  12.    This document applies to version 2.00, written on 1st August 1994,
  13. Copyright (C) 1993,1994 Andy Dean.
  14.  @{" Copying " Link "Copying"}               Distribution details
  15.  @{" Requirements " Link "Requirements"}          What will StickIt2 run on?
  16.  @{" What is StickIt? " Link "What is StickIt?"}      Program description
  17.  @{" Features " Link "Features"}              Features and improvements over StickIt-1.03
  18.  @{" Usage " Link "Usage"}                 How to use the program
  19.  @{" The notes " Link "The notes"}             Editing the note text
  20.  @{" Commodities window " Link "Commodities window"}    Changing the notes' properties
  21.  @{" Configuring " Link "Configuring"}           How to use the tooltypes
  22.  @{" Known Bugs " Link "Known Bugs"}            Extra `features'
  23.  @{" About the Author " Link "About the Author"}      How to contact me
  24.  @{" Credits " Link "Credits"}               Thanks!
  25. @EndNode
  26. @Node "Copying" "StickIt2.guide/Copying"
  27. @Next "Requirements"
  28. @Prev "Main"
  29. @Toc "Main"
  30. Copying and distribution details
  31. ********************************
  32.    Permission is granted to make and distribute verbatim copies of this
  33. manual provided the copyright notice and this permission notice are
  34. preserved on all copies.
  35.    No guarantee of any kind is given that the programs described in
  36. this document are 100% reliable. You are using this material at your
  37. own risk. The author @{i}can not@{ui} be made responsible for any damage which
  38. is caused by using this program.
  39.    This package is freely distributable, but still copyright by Andy
  40. Dean. This means that you can copy it freely as long as you don't ask
  41. for a more than nominal copying fee.
  42.    Permission is granted to include this package in Public-Domain
  43. collections, especially in the excellent Fred Fish Amiga Disk Library
  44. (including CD ROM versions of it). The distribution file may be
  45. uploaded to Bulletin Board Systems or FTP servers. If you want to
  46. distribute this program you must use the original distribution archive
  47. StickIt-2.00.lha.
  48.    This program or the source code (or parts of it) may not be included
  49. or used in commercial programs unless by written permission from the
  50. author.
  51. @EndNode
  52. @Node "Requirements" "StickIt2.guide/Requirements"
  53. @Next "What is StickIt?"
  54. @Prev "Copying"
  55. @Toc "Main"
  56. Requirements
  57. ************
  58.    StickIt2 will run on any Amiga equipped with AmigaDos 2.04 and
  59. above. It requires no third-party libraries, and will work with the
  60. non-scalable diskfont library (version 36) although you won't get
  61. scalable fonts then :-).
  62. @EndNode
  63. @Node "What is StickIt?" "StickIt2.guide/What is StickIt?"
  64. @Next "Features"
  65. @Prev "Requirements"
  66. @Toc "Main"
  67. What is StickIt?
  68. ****************
  69.    StickIt2 is a replacement for the good ol' Post-It note. It allows
  70. you to stick notes on your screen which will be displayed every time
  71. you reboot; useful to remind you of things to do.
  72.    StickIt2 was written with a job to do... to replace all the bits of
  73. paper I used to leave around to remind me to do something. I have tried
  74. to write a program to do that with the minimum of fuss and with a nice
  75. clean Workbench 2 interface. I have tried to make the program
  76. configurable enough for each user's needs, without over-doing it.
  77.    I have tried to incorporate as many of the suggestions made by
  78. others in response to the earlier StickIt-1.03.
  79. An example StickIt2 setup
  80. =========================
  81.    I suggest that the truly organised StickIt2 user should drop the
  82. program into their `WBStartup' directory so that they can be reminded
  83. every time they re-boot their machine.
  84.    To do this, simple drag the program's icon into the `WBStartup'
  85. directory of your boot partition. Run the program and it should warn
  86. you that there is no `StickIt2.notes' file (see @{"Configuring" Link "Configuring"} to see how
  87. to change the default notefile). After clicking on `Ok', the
  88. commodities window should popup. To create a blank `StickIt2.notes'
  89. file, press @{b}Right Amiga + S@{ub}.
  90.    StickIt2 is now ready to use. You can add some notes immediately or
  91. you can close the commodities window, keeping the program in the
  92. background ready for use. To bring back the commodities window, press
  93. @{b}Left Alt + Left Shift + S@{ub}.
  94.    See @{"Configuring" Link "Configuring"}, for more information on customising the program for
  95. your own use.
  96. @EndNode
  97. @Node "Features" "StickIt2.guide/Features"
  98. @Next "Usage"
  99. @Prev "What is StickIt?"
  100. @Toc "Main"
  101. Program features
  102. ****************
  103.    StickIt version 2.00 supports the following features:
  104.    @{b}*@{ub} StickIt2 can have up to 100 notes in use at any time.
  105.    @{b}*@{ub} StickIt2's notes can be in any colour.
  106.    @{b}*@{ub} StickIt2's notes can use any font in any colour, size and style.
  107.      Each note can have its own font.
  108.    @{b}*@{ub} StickIt2's notes are directly editable (like typing text into a
  109.      word processor).
  110.    @{b}*@{ub} StickIt2's notes are resizable using a discrete hidden resize
  111.      gadget.
  112.    @{b}*@{ub} StickIt2's notes can open on any public screen.
  113.    @{b}*@{ub} StickIt2 runs as a commodity.
  114.    @{b}*@{ub} StickIt2 uses the system clipboard.
  115.    @{b}*@{ub} StickIt2 can be run from either Workbench or the CLI with full
  116.      tooltype support in both cases.
  117.    @{b}*@{ub} StickIt2 has a font sensitive GadTools interface designed with the
  118.      excellent "The Designer". See @{"Credits" Link "Credits"}.
  119.    @{b}*@{ub} Documentation in plain ASCII and AmigaGuide formats.
  120.    @{b}*@{ub} StickIt version 2.00 is only 7k larger than StickIt-1.03.
  121.    The limits imposed by the program are:
  122.    @{b}*@{ub} The note may only contain 4k of text (just over 4,000 characters).
  123.    @{b}*@{ub} The title bar may only contain 128 characters of text.
  124. @EndNode
  125. @Node "Usage" "StickIt2.guide/Usage"
  126. @Next "The notes"
  127. @Prev "Features"
  128. @Toc "Main"
  129. How to use the program
  130. **********************
  131.    Starting the program is easy! To start StickIt2 from the Workbench,
  132. simply click on its icon. To start the program from the CLI, just type
  133. @{b}StickIt2@{ub} in a shell window. The program doesn't auto-detach itself from
  134. the shell, to do this start it with @{b}run StickIt2@{ub}.
  135.    The default setup should open a couple of `welcome' notes and also
  136. pop up the commodities window.
  137. @EndNode
  138. @Node "The notes" "StickIt2.guide/The notes"
  139. @Next "Commodities window"
  140. @Prev "Usage"
  141. @Toc "Main"
  142. Editing the notes
  143. *****************
  144.    Unlike the last version of StickIt, the notes under StickIt2 are
  145. editable directly. To do this, just click on the text in the note and a
  146. carat(1) will appear at that position.
  147.    Text entry will then be familiar to word-processor users. The cursor
  148. keys will move the carat around the text and the text around the carat
  149. can be deleted with either the DEL or BACKSPACE keys.
  150.    If the user enters text such that it cannot all fit into the note,
  151. the cursor is positioned at the end of the text in the note, and the
  152. text will be entered as normal - only the user will not be able to see
  153.    To remove the carat from the note, simply click off the note (i.e.
  154. on the Workbench backdrop) or press RETURN.
  155. Resizing a note
  156. ===============
  157.    StickIt2 allows the user to resize the notes to allow more or less
  158. text to be entered than is possible in the default size note. As a
  159. standard resize gadget would be unsightly and spoil the appearance of
  160. the note, a hidden resize gadget is used in StickIt2. This resize
  161. gadget works in exactly the same way as the standard gadget and is
  162. located in the same place (bottom right) in the window. See the diagram
  163. @{b}Resize.ilbm@{ub}, located in the `Docs' directory, if you are unsure.
  164. Hiding a note
  165. =============
  166.    To hide a note from view, click on the close gadget. This doesn't
  167. actually delete the note, simply hides it from view. To re-open the
  168. note, use the commodities window (see @{"Commodities window" Link "Commodities window"}).
  169. Note menu options
  170. =================
  171.    Each note has a menu of commands available to it by pressing the
  172. right mouse button. There are two sub-menus - `Project' and 'Edit'.
  173. Project sub-menu
  174. ================
  175. @{b}Save@{ub}, keyboard shortcut: @{b}Amiga-S@{ub}
  176. --------------------------------
  177.    This saves all the current notes' information to the notefile. See
  178. @{"Configuring" Link "Configuring"}, for information on how to rename this file.
  179.    The notes' position, size, font, colours etc... are saved in the
  180. file. The only thing that isn't saved in the file is the information
  181. about whether the note is currently hidden. This means that when the
  182. user re-opens the file, all notes are shown.
  183. @{b}Commodities Panel@{ub}, keyboard shortcut: @{b}Amiga-P@{ub}
  184. ---------------------------------------------
  185.    This calls up the main commodities window where the notes properties
  186. can be changed (see @{"Commodities window" Link "Commodities window"}).
  187. Edit sub-menu
  188. =============
  189.    StickIt2 supports the Amiga's clipboard with the use of standard
  190. cut, copy and paste commands.
  191. @{b}Copy@{ub}, keyboard shortcut: @{b}Amiga-C@{ub}
  192. --------------------------------
  193.    @{b}Copy@{ub} is used to copy all of the current note's text into the system
  194. clipboard buffer. The text in the note remains unchanged.
  195. @{b}Cut@{ub} keyboard shortcut: @{b}Amiga-X@{ub}
  196. ------------------------------
  197.    @{b}Cut@{ub} also copies all the current note's text into the system
  198. clipboard, but then deletes the text in the note.
  199. @{b}Paste@{ub}, keyboard shortcut: @{b}Amiga-V@{ub}
  200. ---------------------------------
  201.    @{b}Paste@{ub} copies the contents of the clipboard into the note. The pasted
  202. information can be altered slightly in order for it to be editable in
  203. the note. All RETURN and TAB characters are converted into SPACE
  204. characters, to keep the text editable within the note. It is important
  205. to remember this because if the text is then copied back into the
  206. clipboard, these RETURN and TAB characters will have been changed into
  207. SPACE characters.
  208. @{b}Delete@{ub}, keyboard shortcut: @{b}Amiga-B@{ub}
  209. ----------------------------------
  210.    @{b}Delete@{ub} simply deletes the current note's text. The clipboard is not
  211. used in this operation.
  212.    ---------- Footnotes ----------
  213.    (1)  A `carat' is just another name for a `cursor'
  214. @EndNode
  215. @Node "Commodities window" "StickIt2.guide/Commodities window"
  216. @Next "Configuring"
  217. @Prev "The notes"
  218. @Toc "Main"
  219. The commodities window
  220. **********************
  221.    The commodities window is called up by either:
  222.   1. Pressing the keyboard shortcut, by default this is Left Alt + Left
  223.      Shift + S.
  224.   2. Selecting `Commodities panel' from the note menus.
  225.   3. Using Commodore's `Commodities Exchange' program and pressing the
  226.      `Show' gadget.
  227.    The purpose of the commodities window is to alter the notes'
  228. properties (font, colour etc...). Any of the gadgets functions in the
  229. commodities window can be selected by pressing the keyboard shortcut
  230. key, indicated with the underlined letter.
  231.    The commodities window is opened on the default public screen. This
  232. is not the same as the @{b}PUBSCREEN@{ub} tooltype. The default public screen is
  233. usually Workbench, but it can be changed by one of the many freely
  234. distributable public screen utilities.
  235. The commodities window gadgets
  236. ==============================
  237. The notes list
  238. --------------
  239.    On the left of the commodities window is a list of all the current
  240. notes in memory, listed in reverse order of opening. This means that
  241. the notes at the top of the list are opened last, and therefore can
  242. overlap notes lower down the list.
  243.    To open a hidden note or force a note to the front, double-click on
  244. its entry in the notes list.
  245.    To select a note in the notes list, either click on the entry in the
  246. list or click on the note itself. Once a note is selected, it can be
  247. moved up or down by using the `Up' and `Down' buttons below the list.
  248. This is useful if you want to force a note to open on-top of another or
  249. behind all the others.
  250.    A selected note can also be deleted permanently by clicking on the
  251. `Del' button.
  252.    Creating a new note is done with the `New' button; the new note
  253. inherits the default properties chosen by the tooltypes and is placed
  254. at the top of the list.
  255. The title bar text
  256. ------------------
  257.    To change the text to be shown in the title bar of the note, the
  258. user can type into the `Title bar' text gadget.
  259. Note colours
  260. ------------
  261.    The user can select the note background colour and text colour with
  262. the `Note colours' gadgets. The cycle gadget chooses either the
  263. background colour or text colour, and the palette gadget shows the
  264. current colour. To change either of the colours, simply click on the
  265. colour in the palette gadget.
  266. Note font
  267. ---------
  268.    The current note's font and size is shown next to the `Font...'
  269. button. To change it, select the `Font...' button and a standard font
  270. requester will appear. After selecting the font for the note, the
  271. choice will be shown next to the `Font...' button and the note will be
  272. redrawn with the new font.
  273. Public screen
  274. -------------
  275.    By default, all notes open on the screen specified by the @{b}PUBSCREEN@{ub}
  276. tooltype (usually Workbench). To force the note to open on another
  277. public screen, type the screen's name in this text gadget. The public
  278. screen name is case sensitive, so the public screen name @{b}TERM@{ub} is not
  279. the same as @{b}Term@{ub} for example.
  280. Commodities window menu options
  281. ===============================
  282.    The commodities window has a menu of commands available to it by
  283. pressing the right mouse button. There are two sub-menus - `Project'
  284. and 'Notes'.
  285. Project sub-menu
  286. ================
  287. @{b}Save@{ub}, keyboard shortcut: @{b}Amiga-S@{ub}
  288. --------------------------------
  289.    This saves all the current notes' information to the notefile. See
  290. @{"Configuring" Link "Configuring"}, for information on how to change rename this file.
  291.    The notes' position, size, font, colours etc... are saved in the
  292. file. The only thing that isn't saved in the file is the information
  293. about whether the note is currently hidden. This means that when the
  294. user re-opens the file, all notes are shown.
  295. @{b}About@{ub}, keyboard shortcut: @{b}Amiga-?@{ub}
  296. ---------------------------------
  297.    Brings up information about the program, including the current
  298. keyboard shortcut to bring up the commodities window.
  299. @{b}Hide@{ub}, keyboard shortcut: @{b}Amiga-H@{ub}
  300. --------------------------------
  301.    This will close the commodities window. If the user has changed any
  302. data they will be warned before the window closes, unless the tooltype
  303. @{b}HIDEWARN=NO@{ub}.
  304. @{b}Quit@{ub}, keyboard shortcut: @{b}Amiga-Q@{ub}
  305. --------------------------------
  306.    Quits the program, removing it entirely from memory. The user will
  307. be warned if they need to save any data before the program quits.
  308. Notes sub-menu
  309. ==============
  310. @{b}New note@{ub}, keyboard shortcut: @{b}Amiga-N@{ub}
  311. ------------------------------------
  312.    This is the same as clicking on the `New' button; the new note
  313. inherits the default properties chosen by the tooltypes and is placed
  314. at the top of the list.
  315. @{b}Delete note@{ub}, keyboard shortcut: @{b}Amiga-D@{ub}
  316. ---------------------------------------
  317.    This is the same as clicking on the `Del' button - the selected note
  318. is deleted permanently.
  319. @{b}Redraw notes@{ub}, keyboard shortcut: @{b}Amiga-R@{ub}
  320. ----------------------------------------
  321.    If the user changes the order of the notes in the listview, they can
  322. see the effects by forcing StickIt2 to reopen all the notes as if it
  323. had just started up. This is useful if you intend to overlap notes on
  324. the screen.
  325. @EndNode
  326. @Node "Configuring" "StickIt2.guide/Configuring"
  327. @Next "Known Bugs"
  328. @Prev "Commodities window"
  329. @Toc "Main"
  330. Configuring StickIt2 with the tooltypes
  331. ***************************************
  332.    StickIt2 uses the Amiga tooltypes to configure the program. If
  333. StickIt2 is run from the Workbench it will read the tooltypes from the
  334. icon; if it is run from the CLI the tooltypes can be passed as
  335. arguments to the program. Upon startup, the program will read the
  336. tooltypes and this will determine how the program is to be set up.
  337. Editing the icon's tooltypes
  338. ============================
  339.    To edit the tooltypes in the StickIt2 icon, click on the icon and
  340. select `Information' from the `Icons' sub-menu on Workbench. A window
  341. should pop up with a list showing the current tooltypes.
  342.    IMPORTANT: Any tooltype in brackets, `(' and `)', is commented out
  343. and ignored by the program. For example
  344.      NOTEFILE=Work:StickIt2/StickIt2.notes
  345.    would set the current notefile to @{b}Work:StickIt2/StickIt2.notes@{ub},
  346. whereas
  347.      (NOTEFILE=Work:StickIt2/StickIt2.notes)
  348.    would be ignored and the default notefile would be used.
  349.    The original distribution should have all the tooltypes commented
  350. out (except @{b}DONOTWAIT@{ub}, which is required by Workbench and not used by
  351. StickIt2 directly).
  352.    To save the edited tooltypes, click on `Save' in the information
  353. window. The new tooltypes will come into effect next time StickIt2 is
  354. CLI tooltype arguments
  355. ======================
  356.    As was mentioned previously (see @{"Usage" Link "Usage"}) StickIt2 can also be started
  357. from the CLI or Shell. To send tooltypes to the program, you place them
  358. after the program name, for example
  359.      StickIt2 "NOTEFILE=Work:StickIt2/StickIt2.notes" "CX_POPUP=NO"
  360. The tooltypes
  361. =============
  362. @{b}NOTEFILE@{ub}, default: @{b}NOTEFILE=StickIt2.notes@{ub}
  363. ------------------------------------------
  364.    This is the name of the file that will contain all the note
  365. information. The default notefile is located in the same directory as
  366. the program, but the user may want to change this to @{b}s:StickIt2.notes@{ub}
  367. for example.
  368.    Unlike previous versions of StickIt, StickIt2 doesn't @{i}need@{ui} a
  369. notefile to exist for it to work. If the user selects a notefile that
  370. doesn't exist, the program will give a warning upon startup but
  371. continue. When the user next selects `Save', this new notefile is
  372. written.
  373.    The notefiles of previous versions of StickIt are not compatible
  374. with StickIt2.
  375. @{b}NOTEHEIGHT@{ub}, default: @{b}NOTEHEIGHT=55@{ub}
  376. ----------------------------------
  377.    The height in pixels of the new notes when they are created.
  378. @{b}NOTEWIDTH@{ub}, default: @{b}NOTEWIDTH=100@{ub}
  379. ---------------------------------
  380.    The width in pixels of the new notes when they are created.
  381. @{b}BACKCOLOUR@{ub}, default: @{b}BACKCOLOUR=2@{ub}
  382. ---------------------------------
  383.    The colour of the background of the note. The default colour under
  384. the default Workbench setup is white, but if you are using more than a
  385. 4 colour Workbench, you are free to choose any number in your palette
  386. (I use an 8 colour Workbench and colour 7 is yellow. Therefore, I set
  387. @{b}BACKCOLOUR=7@{ub}).
  388.    It should be noted (no pun intended!) that the colours are numbered
  389. from 0 upwards. Therefore, a 4 colour Workbench has colours 0,1,2 and 3.
  390.    StickIt2 now also accepts both the English and American spellings of
  391. the word `colour'; i.e. the tooltypes @{b}BACKCOLOUR@{ub} and @{b}BACKCOLOR@{ub} are
  392. identical.
  393. @{b}TEXTCOLOUR@{ub}, default: @{b}TEXTCOLOUR=1@{ub}
  394. ---------------------------------
  395.    The colour of the text in the note. The default colour under the
  396. default Workbench setup is black, all the information about colour in
  397. the @{b}BACKCOLOUR@{ub} sub-section is applicable here.
  398. @{b}NOTEFONT@{ub}, no default
  399. --------------------
  400.    The default font to be used in the notes. There is no default given,
  401. so notes are given the default system font which is topaz 8. I suggest
  402. the use of `Janod' font given away with Commodore's AmigaGuide
  403. distribution. `Janod' is a very small but readable font, allowing you
  404. to cram lots of info into a small note. I therefore set
  405. @{b}NOTEFONT=Janod.font@{ub} in my tooltypes.
  406.    It is important to append a `.font' onto the end of the fontname,
  407. otherwise the Amiga won't open the font.
  408. @{b}FONTSIZE@{ub}, default: @{b}FONTSIZE=8@{ub}
  409. -----------------------------
  410.    The default font size in points.
  411. @{b}PUBSCREEN@{ub}, default: @{b}PUBSCREEN=Workbench@{ub}
  412. ---------------------------------------
  413.    This is the default public screen onto which the notes should open.
  414. The default screen is Workbench, but the user could open all the notes
  415. on a different public screen if they wish.
  416.    If the chosen public screen is not currently open, the notes are
  417. opened on the default system public screen (usually Workbench). The
  418. public screen name is also case sensitive, so @{b}PUBSCREEN=TERM@{ub} is not the
  419. same as @{b}PUBSCREEN=Term@{ub} for example.
  420. @{b}CLIPUNIT@{ub}, default: @{b}CLIPUNIT=0@{ub}
  421. -----------------------------
  422.    This is the default clipboard unit that the program uses for all its
  423. cuts, copys and pastes. Most programs use clipunit 0, so it is unlikely
  424. that you would ever wish to change this.
  425. @{b}DELAY@{ub}, default: @{b}DELAY=0@{ub}
  426. -----------------------
  427.    In order to stop disk thrashing (several programs all trying to
  428. access a disk at the same time) StickIt2 can be told to wait a short
  429. while after loading before it loads in its notefile. If StickIt2 is
  430. placed in the WBStartup on your hard disk, setting @{b}DELAY=5@{ub} will produce
  431. a delay of 5 seconds which is probably adequate. If StickIt2 is started
  432. from a floppy, a larger delay value may be needed.
  433. @{b}EMPTYQUIT@{ub}, default: @{b}EMPTYQUIT=NO@{ub}
  434. --------------------------------
  435.    If StickIt2 finds that there are no notes in the notefile upon
  436. startup, setting @{b}EMPTYQUIT=YES@{ub} will make the program quit and free up
  437. its memory. The default setting keeps the program resident allowing it
  438. to be called up by pressing its hotkey (see later) or using Commodore's
  439. `Commodities Exchange' program.
  440. @{b}HIDEWARN@{ub}, default: @{b}HIDEWARN=YES@{ub}
  441. -------------------------------
  442.    By default, StickIt2 will warn you if you've changed any data and
  443. you try and close the commodities window. For those who wish to live
  444. dangerously, set @{b}HIDEWARN=NO@{ub}.
  445.    StickIt2 will always remind you that you've changed data if you try
  446. and quit the program.
  447. @{b}CX_PRIORITY@{ub}, default: @{b}CX_PRIORITY=0@{ub}
  448. -----------------------------------
  449.    As StickIt2 runs as a commodity, it supports the 3 standard
  450. commodity tooltypes. @{b}CX_PRIORITY@{ub} lets you set the program's priority
  451. compared to other running commodities. Most users will find it
  452. unnecessary to change this.
  453. @{b}CX_POPUP@{ub}, default: @{b}CX_POPUP=YES@{ub}
  454. -------------------------------
  455.    When StickIt2 starts, it will by default show the commodities
  456. window. To turn this off, set @{b}CX_POPUP=NO@{ub}.
  457. @{b}CX_POPKEY@{ub}, default: @{b}CX_POPKEY=lalt lshift s@{ub}
  458. -------------------------------------------
  459.    The keyboard shortcut to call up the commodities window is set by
  460. @{b}CX_POPKEY@{ub}. The default value lets you call up the commodities window by
  461. pressing Left Alt + Left Shift + S.
  462. @{b}DONOTWAIT@{ub}
  463. ---------
  464.    This is used by Workbench if StickIt2 dropped into the WBStartup
  465. directory to run at boot-up. It simply allows the Amiga to continue
  466. with the startup even though StickIt2 doesn't return immediately.
  467. @EndNode
  468. @Node "Known Bugs" "StickIt2.guide/Known Bugs"
  469. @Next "About the Author"
  470. @Prev "Configuring"
  471. @Toc "Main"
  472. Known Bugs
  473. **********
  474.    StickIt version 2.00 has a few known bugs in the program. @{i}None of
  475. these are remotely dangerous@{ui}, just annoying.
  476.    @{b}*@{ub} The carat can sometimes be drawn in the border of the note window.
  477.      This is because the carat is drawn 2 pixels to the right of the
  478.      actual carat position, and at the end of some lines this goes into
  479.      the border. Cure: Don't worry about it.
  480.    @{b}*@{ub} Very small (unreadable) fonts sometimes contain characters so
  481.      small that the carat doesn't move around properly. Cure: Use a
  482.      bigger font (what are you doing with 3 point text anyway?).
  483.    @{b}*@{ub} If you paste a lot of text into a note and the text spills out of
  484.      the note, the carat is not shown correctly positioned. This is
  485.      because after the paste, StickIt2 calculates the new position of
  486.      the carat and as this is out of the note, it doesn't try and move
  487.      it there. Cure: Resize the note and make it bigger.
  488.    I'm not going to spend any time removing the annoying note text and
  489. carat bugs because the text entry routines will probably need recoding
  490. if I am to add "drag a box" type editing. The current routines are not
  491. as efficient as they could be.
  492.    The following are annoying, but worth noting:
  493.    @{b}*@{ub} Whenever a simple requester is opened (an "Okay" / "Cancel" type),
  494.      the program effectively stops running until the requester is
  495.      satisfied. This means that the notes stop being refreshed if they
  496.      become "damaged". There is no way around this, unless I replace
  497.      the requesters with windows which is far too much hastle.
  498.      Note refreshing continues as normal when the font requester is
  499.      open, as I make use of the ASL requester's callback hook function.
  500.    @{b}*@{ub} The commodities window always opens in the same place each time,
  501.      even the if the user moves it before closing it. I could edit the
  502.      `The Designer's code to stop this, but I don't really want to edit
  503.      computer generated code.
  504. @EndNode
  505. @Node "About the Author" "StickIt2.guide/About the Author"
  506. @Next "Credits"
  507. @Prev "Known Bugs"
  508. @Toc "Main"
  509. About the Author
  510. ****************
  511.    My address is:
  512.                                                               Andy Dean
  513.                                            Electronic Engineering Dept.
  514.                                               University College London
  515.                                                        Torrington Place
  516.                                                                  London
  517.                                                                WC1E 7JE
  518.                                                                 England
  519.    I also have an Internet Email address:
  520.                                        @{b}adean@eleceng.ucl.ac.uk@{ub}
  521.    StickIt 2.00 was written using:
  522.    - `Dice' C compiler, version 2.07.56R (see @{"Credits" Link "Credits"}).
  523.    - `The Designer', version 1.3 (see @{"Credits" Link "Credits"}).
  524.    and has been tested on:
  525.    - Amiga A4000/EC030 + 68882 FPU, Workbench 3.0, 4Mbyte FAST RAM,
  526.      2Mbyte CHIP RAM, 130Mbyte IDE hard drive
  527.    - Amiga A500, Workbench 2.04, 2Mbyte FAST RAM, 1Mbyte CHIP RAM, A590
  528.      85Mbyte SCSI hard drive, Microbotics VXL*30 accelerator card (no
  529.      FAST RAM)
  530.    - Amiga A1200, Workbench 3.0, 4Mbyte FAST RAM, 2Mbyte CHIP RAM,
  531.      85Mbyte IDE hard drive, Power Computing PC1204 (with 20MHz 68882
  532.      FPU)
  533. @EndNode
  534. @Node "Credits" "StickIt2.guide/Credits"
  535. @Prev "About the Author"
  536. @Toc "Main"
  537. Credits
  538. *******
  539.    I'd like to thank:
  540.    Matt Dillon for the excellent `Dice' C compiler.
  541.    Ian O'Conner for the excellent `The Designer' window designer.
  542.    All the documentation for StickIt2 was done using the freely
  543. distributable TeX and @{b}makeinfo@{ub} distributions. Thanks to all involved,
  544. and those responsible for the conversions to the Amiga.
  545.    Thanks go out to all the Amiga public domain / freeware / shareware
  546. authors for loads of excellent software.
  547.    I'd also like to thank those who beta tested StickIt2.
  548.    Thanks also to everyone who wrote to me about the original StickIt.
  549. I hope that StickIt2 incorporates most of your suggestions, and you
  550. feel it a worthy upgrade. Although I said in the original documentation
  551. that I had no intention of improving the program, the response from the
  552. users was so good it encouraged me to write StickIt2.
  553.    If you find any bugs in StickIt2, write to me and send me as much
  554. info as possible about the bug (how to re-create it, any error messages
  555. the program may generate). Please include a detailed description of the
  556. system you are running StickIt2 on (version of Workbench, processor,
  557. memory, other commodities running etc...).
  558.    As I have said before I have no intention to continue improving the
  559. program, as I have a PhD to be getting on with. However, there are a
  560. few additions that may be added in due time:
  561.    @{b}*@{ub} Optional, save an icon with the notefile.
  562.    @{b}*@{ub} Add preferences window, so that the user doesn't need to change
  563.      the tooltypes in the icon by hand.
  564.    @{b}*@{ub} "Drag a box" editing in the notes.
  565.    @{b}*@{ub} A "Pop note up at a certain time" facility.
  566.    @{b}*@{ub} Maybe an ARexx port.
  567.    Finally, if you use and enjoy this software then send me a postcard
  568. to tell me how far StickIt2 has reached. Go on, it'll only take a few
  569. minutes...
  570.                                                            Many thanks,
  571.                                                               Andy Dean
  572. @EndNode
  573.